home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 008a / m2l9208.zip / MAK2LINE.DOC < prev    next >
Text File  |  1992-02-16  |  13KB  |  319 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                              Program MAK2LINE
  23.  
  24.                Make 2-Line Elements using Keplerian Elements
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                   (C) Copyright 1992, All Rights Reserved
  33.  
  34.                           by David H. Ransom, Jr.
  35.                           Rancho Palos Verdes, CA
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                Version  9208
  42.                              February 16, 1992
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                             BBS: (310) 541-7299
  49. MAK2LINE Program Documentation                                    Page 1
  50.  
  51.  
  52.  
  53. INTRODUCTION
  54. ------------
  55.  
  56.      This program provides a means to individuals without modems to receive 
  57. the so-called "Keplerian Orbital Elements" and reliably prepare "2-Line 
  58. Orbital Elements" as required by satellite tracking programs such as my own 
  59. STSORBIT and STSORBIT PLUS as well as Paul Traufler's excellent TRAKSAT and 
  60. other similar programs. However, more information is included in the 2-line 
  61. orbital element set than is usually included in the Keplerian orbital 
  62. elements; this means that the "missing" information must either be obtained 
  63. from other sources or be set to a specified value or zero. These 
  64. instructions and the example and sample form which follows will help the 
  65. unskilled user to do these tasks.
  66.      The current version of MAK2LINE is always available on my RPV 
  67. ASTRONOMY BBS at (310) 541-7299 in Rancho Palos Verdes, CA near Los 
  68. Angeles. It is a very busy system, so please be patient (especially during 
  69. Space Shuttle missions).
  70.      Program MAK2LINE is copyrighted software. Use it if you like it, 
  71. discard it if you don't. There are no warranties of any kind. Program 
  72. registration is not required; however, if you use and enjoy Program 
  73. MAK2LINE, a donation of US$10.00 will be much appreciated and will encourage 
  74. me to continue supporting the amateur radio and satellite tracking 
  75. communities with software big and small. A donation of US$10.00 will also 
  76. bring you the latest version of the program on disk. Please specify disk 
  77. size, 5-1/4" 360K or 3-1/2" 720K.
  78.  
  79.  
  80.                                         David H. Ransom, Jr.
  81.                                         7130 Avenida Altisima
  82.                                         Rancho Palos Verdes, CA  90274
  83. MAK2LINE Program Documentation                                    Page 2
  84.  
  85.  
  86.  
  87. PROGRAM NOTES
  88. -------------
  89.  
  90.      Program MAK2LINE has but a single purpose: to prepare 2-line orbital 
  91. elements from Keplerian orbital elements by means of user keyboard input. 
  92. Since the program is designed only to transcribe valid data from one format 
  93. to another, no error checking is performed and the program makes no tests 
  94. of the "reasonableness" of the various data and parameters. The user is 
  95. therefore cautioned to check his data before using this program, or to use 
  96. the resulting data with caution until it has been verified.
  97.      The information shown below is usually included in the Keplerian 
  98. orbital elements as received via modem or via voice (amateur radio or 
  99. telephone). This sample is an actual file from Space Shuttle Flight STS-42 
  100. in January of 1992 and received via modem direct from the NASA Johnson 
  101. Space Center:
  102.  
  103.      Satellite: STS-42
  104.      Catalog number: 21846
  105.      Epoch time:      92024.87908918        (24 JAN 92   21:05:53.31 UTC)
  106.      Element set:     JSC-005
  107.      Inclination:       56.9720 deg
  108.      RA of node:       233.8707 deg          Space Shuttle Flight STS-42
  109.      Eccentricity:     .0009197                SGP4 Keplerian Elements
  110.      Arg of perigee:   264.4174 deg         from NASA flight Day 3 vector
  111.      Mean anomaly:      95.5875 deg
  112.      Mean motion:   15.91353638 rev/day               G. L. Carman
  113.      Decay rate:    2.10000e-03 rev/day^2      NASA Johnson Space Center
  114.      Epoch rev:              37
  115.  
  116.      If you compare the information requested by Program MAK2LINE (as shown 
  117. on the example on the following page) with that above, several items are 
  118. missing or may be in a slightly different format. Here are some 
  119. suggestions. 
  120.  
  121. 1.   A sample form is included in this documentation which will assist you 
  122.      when receiving Keplerian orbital information by voice line or when it 
  123.      is transmitted by amateur radio link. Note that the form includes 
  124.      lines for "IAU Designation" and "BSTAR Drag"; these items are 
  125.      frequently omitted from voice transmissions.
  126.  
  127. 2.   The NORAD Number is assigned by the U. S. Space Command at Cheyenne 
  128.      Mountain after a satellite has been successfully launched. Initial or 
  129.      pre-launch Keplerian elements may use the mission number or some other 
  130.      convenient number for this item. Most tracking programs will accept 
  131.      any number here.
  132.  
  133. 3.   The IAU (International Astronomical Union) Designation is often not 
  134.      assigned until well after a flight is in progress; press ENTER to use 
  135.      all spaces for this item.
  136.  
  137. 4.   For the 2-line orbital element set, the element set number (shown as 
  138.      "JSC-005" in the example above) MUST be numeric. For this example, 
  139.      enter "5" or "005". Most tracking programs will accept any number for 
  140.      this item, up to a maximum of FOUR DIGITS.
  141. MAK2LINE Program Documentation                                    Page 3
  142.  
  143.  
  144.  
  145. 5.   The "Epoch Rev/Orbit" is the orbit number at the epoch (the instant 
  146.      when the data is taken). Up to FOUR DIGITS may be entered here but 
  147.      except for the orbit number on displays, this number has no effect on 
  148.      the propagated orbit.
  149.  
  150. 6.   When MAK2LINE asks for "NDOT2 Drag/Decay", the information being 
  151.      requested is the "Decay rate" in the Keplerian elements. It may be 
  152.      entered in the form shown in the example or as a decimal fraction such 
  153.      as ".0021" (which is identical to the "2.10000e-03" in scientific 
  154.      notation as used in the example).
  155.  
  156. 7.   When MAK2LINE asks for "NDDOT6 Drag", press ENTER to insert a value of 
  157.      zero. This should be satisfactory for most tracking programs.
  158.  
  159. 8.   When MAK2LINE asks for "BSTAR", you may press ENTER to insert a value 
  160.      of zero. This will be satisfactory for times very close to the Epoch 
  161.      Time for the elements. However, as time progresses the satellite may 
  162.      lag behind the propagated (projected) ground track if no value is 
  163.      avaialble for BSTAR. It may be satisfactory to use a value from a 
  164.      similar satellite or a prior set of 2-line elements in order to 
  165.      achieve more accurate long term results.
  166.  
  167. 9.   After the last data item has been entered, MAK2LINE will request the 
  168.      filename to which the 2-line orbital data is to be written. Enter the 
  169.      full file name such as "TESTSAT.TXT". The file will be written to the 
  170.      current drive and directory by default. A drive and/or path may 
  171.      optionally be included in the filename entered. Any prior file by the 
  172.      same name will be overwritten.
  173.  
  174. 10.  If you make a mistake during the data entry process, you may use the 
  175.      BACKSPACE key until ENTER has been pressed. If you wish to cancel the 
  176.      program without writing the data to a file, press CTRL-C.
  177.  
  178.      Finally, a word about the NDOT2 and BSTAR parameters. Both the U. S. 
  179. Space Command (formerly NORAD) and Johnson Space Center have been known to 
  180. "tweak" these values for a variety of reasons. Usually it is because the 
  181. orbit is in a state of change due, perhaps, to maneuvers or excessive drag. 
  182. A positive value for BSTAR, which indicates positive acceleration and is 
  183. somewhat unusual (and often also an indication of "tweaking"), is NOT 
  184. handled correctly by MAK2LINE at this point and must be manually edited. If 
  185. this proves troublesome, it will be corrected in a future release of the 
  186. program.
  187. MAK2LINE Program Documentation                                    Page 4
  188.  
  189.  
  190.  
  191. PROGRAM MAK2LINE EXAMPLE
  192. ------------------------
  193.  
  194. Enter 2-LINE ELEMENTS
  195.  
  196. Enter the required data as prompted. Most essential data is
  197. so-called Keplerian Orbital Data available to amateur radio
  198. enthusiasts. Other data may be inserted if available or may
  199. be omitted if not. Accuracy may be affected, see documentation.
  200.  
  201. Enter Satellite Name (15 chars max):      sts-42
  202. Enter NORAD Number (NNNNN):               21846
  203. Enter IAU Designation (8 chars max):      92  2  A
  204. Enter Epoch Time (YYDDD.TTTTTTTT):        92024.87908918
  205. Enter Element Set Number (NNN):           5
  206. Enter Inclination (DDD.DDDD):             56.972
  207. Enter RA of Ascend Node (DDD.DDDD):       233.8707
  208. Enter Eccentricity (.NNNNNNN):            .0009197
  209. Enter Arg of Perigee (DDD.DDDD):          264.4174
  210. Enter Mean Anomaly (DDD.DDDD):            95.5875
  211. Enter Mean Motion (NN.NNNNNNNN):          15.91353638
  212. Enter Epoch Rev/Orbit (NNN):              37
  213. Enter NDOT2 Drag/Decay (.NNNNNNNN):       .0021
  214. Enter NDDOT6 Drag (NNNNN-N):
  215. Enter BSTAR (NNNNN-N):                    61700-3
  216.  
  217. Satellite Name (15 chars max):            Sts-42
  218. NORAD Number (NNNNN):                     21846
  219. IAU Designation (8 chars max):            92  2  A
  220. Epoch Time (YYDDD.TTTTTTTT):              92024.87908918
  221. Element Set Number (NNN):                  5
  222. Inclination (DDD.DDDD):                    56.9720
  223. RA of Ascend Node (DDD.DDDD):             233.8707
  224. Eccentricity (.NNNNNNN):                  .0009197
  225. Arg of Perigee (DDD.DDDD):                264.4174
  226. Mean Anomaly (DDD.DDDD):                   95.5875
  227. Mean Motion (NN.NNNNNNNN):                 15.91353638
  228. Epoch Rev/Orbit (NNN):                     37
  229. NDOT2 Drag/Decay (.NNNNNNNN):             .00210000
  230. NDDOT6 Drag (NNNNN-N):                    00000-0
  231. BSTAR (NNNNN-N):                          61700-3
  232.  
  233. Sts-42
  234. 1 21846U 92  2  A 92024.87908918  .00210000  00000-0  61700-3 0    59
  235. 2 21846  56.9720 233.8707 0009197 264.4174  95.5875 15.91353638   379
  236. MAK2LINE Program Documentation                                    Page 5
  237.  
  238.  
  239.  
  240. RECEIVED KEPLERIAN ORBITAL DATA
  241. -------------------------------
  242.  
  243.      This form is provided as a convenience to users receiving Keplerian 
  244. orbital data via voice link (amateur radio or telephone). Each set of 
  245. underline characters indicates an expected character; the decimal point is 
  246. shown where expected (if appropriate for the item). Make multiple copies of 
  247. this form prior to a mission.
  248.  
  249.  
  250. Satellite:          __ __ __ __ __ __ __ __ __ __ __ __ __ __ __
  251.  
  252.  
  253. Catalog Number:     __ __ __ __ __
  254.  
  255.  
  256. IAU Designation:    __ __ __ __ __ __ __ __
  257.      
  258.  
  259. Epoch Time:         __ __ __ __ __ . __ __ __ __ __ __ __ __
  260.  
  261.  
  262. Element Set:        __ __ __ __
  263.  
  264.  
  265. Inclination:        __ __ __ . __ __ __ __
  266.  
  267.  
  268. RA of Node:         __ __ __ . __ __ __ __
  269.  
  270.  
  271. Eccentricity:       . __ __ __ __ __ __ __
  272.  
  273.  
  274. Arg of Perigee:     __ __ __ . __ __ __ __
  275.  
  276.  
  277. Mean Anomaly:       __ __ __ . __ __ __ __
  278.  
  279.  
  280. Mean Motion:        __ __ . __ __ __ __ __ __ __ __
  281.  
  282.  
  283. Decay Rate:         . __ __ __ __ __ __ __ __
  284.  
  285.  
  286. BSTAR Drag:         __ __ __ __ __ - __
  287.  
  288.  
  289. Epoch Rev:          __ __ __ __
  290. MAK2LINE Program Documentation                                    Page 6
  291.  
  292.  
  293.  
  294. MAK2LINE REVISION HISTORY
  295. -------------------------
  296.  
  297.      Each released version of MAK2LINE uses a four digit revision code such 
  298. as 9208. The first two digits indicate the year and the second two digits 
  299. indicate the week of the year. In some cases, an additional letter suffix 
  300. is added to distinguish changes occuring within the same week. A partial 
  301. week at the beginning or end of the year is counted as a full week. Using      
  302. this method, a year will typically have 53 weeks although it is possible to 
  303. have 54 weeks in a leap year (1972 is an example). The current year-week 
  304. revision code is shown on the Julian Date display, Display Mode 7, using my 
  305. program ASTROCLK.
  306.      This section records the revision history of program MAK2LINE through 
  307. all of the minor twists and turns that usually accompany the evolution of 
  308. such a program. It illustrates the tortuous process of maintaining and 
  309. refining a program as ideas and problems are reported from every quarter. 
  310. It may also be helpful to users who are upgrading from one version to 
  311. another to find out what has changed. This section may also describe recent 
  312. changes not included in the main documentation.
  313.  
  314.  
  315. Version 9208  02/16/92
  316. ----------------------
  317. -Initial public release of the program.
  318. -User comments and suggestions are welcome.
  319.